package com.android.internal.telephony;

/* Copyright (C) 2007 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*      http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/

//package com.android.internal.telephony;

/**
* Interface used to interact with the phone.  Mostly this is used by the
* TelephonyManager class.  A few places are still using this directly.
* Please clean them up if possible and use TelephonyManager insteadl.
*
* {@hide}
*/
public interface ITelephony {

   /**
    * End call or go to the Home screen
    *
    * @return whether it hung up
    */
   boolean endCall();

   /**
    * Answer the currently-ringing call.
    *
    * If there's already a current active call, that call will be
    * automatically put on hold.  If both lines are currently in use, the
    * current active call will be ended.
    *
    * TODO: provide a flag to let the caller specify what policy to use
    * if both lines are in use.  (The current behavior is hardwired to
    * "answer incoming, end ongoing", which is how the CALL button
    * is specced to behave.)
    *
    * TODO: this should be a oneway call (especially since it's called
    * directly from the key queue thread).
    */
   void answerRingingCall();

   /**
    * Silence the ringer if an incoming call is currently ringing.
    * (If vibrating, stop the vibrator also.)
    *
    * It's safe to call this if the ringer has already been silenced, or
    * even if there's no incoming call.  (If so, this method will do nothing.)
    *
    * TODO: this should be a oneway call too (see above).
    *       (Actually *all* the methods here that return void can
    *       probably be oneway.)
    */
   void silenceRinger();

}
